home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / ansi / scrlit18.zip / SCROLLIT.DOC < prev    next >
Text File  |  1993-10-19  |  39KB  |  916 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                                     SCROLLit
  9.  
  10.  
  11.  
  12.                            Advanced ScrollBack Buffer
  13.  
  14.  
  15.  
  16.                                   Version 1.8
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                                Copyright 1992-93
  23.                               All Rights Reserved
  24.  
  25.  
  26.  
  27.  
  28.                                        By
  29.  
  30.  
  31.  
  32.  
  33.                           Bromfield Software Products
  34.                                  P.O. Box 70081
  35.                                 Ottawa, Ontario
  36.                                     K2P 2M3
  37.                                      Canada
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.                              Compuserve 71054,3051
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.                
  54.                                     _______
  55.                                ____|__     |               (TM)
  56.                             --|       |    |-------------------
  57.                               |   ____|__  |  Association of
  58.                               |  |       |_|  Shareware
  59.                               |__|   o   |    Professionals
  60.                             -----|   |   |---------------------
  61.                                  |___|___|    MEMBER
  62.  
  63.  
  64.        License
  65.  
  66.        SCROLLit  is  NOT free  software,  but  is  being distributed  as
  67.        "shareware".
  68.  
  69.        Non-registered  users  of this  software  are  granted a  limited
  70.        license to use this program for a trial period of thirty days for
  71.        the purpose  of determining  if SCROLLit  is  suitable for  their
  72.        needs.  At  the  end of  this  trial  period,  you should  either
  73.        register your copy or discontinue using SCROLLit.
  74.  
  75.        Whether or not you  register SCROLLit, we encourage you  to share
  76.        the unregistered  version of  the program  with your friends  and
  77.        colleagues and to upload it to  any BBS's you use. Please be sure
  78.        to keep all the files together; a complete list of  files appears
  79.        in README.DOC.
  80.  
  81.  
  82.  
  83.        Introduction - What is SCROLLit?
  84.  
  85.        SCROLLit is  a memory  resident (TSR)  program that captures,  in
  86.        full color,  the lines  of text  that scroll off  the top  of the
  87.        video  screen  and stores  them in  an  XMS, EMS  or conventional
  88.        memory 'scrollback' buffer  of a  size specified by  the user.  A
  89.        fast compression technique is  used to store more than  twice the
  90.        number of lines in the available buffer space. 
  91.  
  92.        SCROLLit  can  then be  activated or  'popped  up' over  any non-
  93.        graphical  program   by  pressing  the  scroll   lock  key.  Once
  94.        activated,  SCROLLit will let you  scroll back through this saved
  95.        information, line by line  or page by  page. SCROLLit has a  fast
  96.        search  capability as well  as a block-write  feature that allows
  97.        you  to mark  a block  of lines  for  writing to  a disk  file or
  98.        sending to your printer.
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.                                                                        1
  123.  
  124.  
  125.        Capturing Lines
  126.  
  127.        Once resident,  SCROLLit monitors video activity  to capture text
  128.        lines  that are scrolled off the top  of the screen. You may wish
  129.        to look  back through the  output of the  DIR command in  DOS, or
  130.        review the progress of a Bulletin Board (BBS) session while using
  131.        your communications software, for example.
  132.  
  133.        A program can  scroll the  screen in three  ways: DOS  (interrupt
  134.        21h)  function calls,  BIOS (interrupt  10h) function  calls, and
  135.        direct  writing to video memory. SCROLLit is able to capture both
  136.        DOS and BIOS scrolling, but not the scrolling performed by direct
  137.        screen writing. Fortunately, many programs that use direct screen
  138.        writing  can be configured to use BIOS function calls. Appendix 1
  139.        describes how to reconfigure two popular  communications programs
  140.        (Qmodem and  Telix) to  use  BIOS scrolling,  rather than  direct
  141.        screen writing. 
  142.  
  143.        Some programs clear the  screen rather than scrolling  old output
  144.        off  the top  of the  screen. Monitoring  DOS and  BIOS scrolling
  145.        would not capture  this output because no scrolling  is involved.
  146.        To get around this problem, SCROLLit monitors BIOS 'clear-screen'
  147.        requests.  When a  clear-screen request  has been  made, SCROLLit
  148.        copies the entire screen to the scrollback buffer before the BIOS
  149.        clears  the  screen. As  a result,  you  will find  that SCROLLit
  150.        captures more output than most other scrollback buffer utilities.
  151.  
  152.        Disable Screen Capture Temporarily 
  153.  
  154.        SCROLLit's capturing of screen scrolling and clear-screens can be
  155.        temporarily disabled by typing:
  156.  
  157.                  SCROLLit /-
  158.  
  159.        Screen capturing can later be re-enabled with the /+ command line
  160.        switch.  It may  be  useful to  disable  screen capturing  before
  161.        executing a program that  generates a lot of scrolling  or clear-
  162.        screens, but that  you do  not wish captured  in your  scrollback
  163.        buffer. WordPerfect is a good example of this. In WordPerfect, as
  164.        you page  through your document, SCROLLit  would normally capture
  165.        each page into the scrollback buffer, potentially taking up a lot
  166.        of  buffer  space.  You  may   find  it  convenient  to   execute
  167.        WordPerfect using a simple batch file as follows:
  168.  
  169.                  CD\WP51
  170.                  CLS
  171.                  SCROLLIT /-
  172.                  WP51
  173.                  SCROLLIT /+
  174.  
  175.        SCROLLit  can still be popped  up when capturing  is disabled, so
  176.        that you can still  scroll back through lines that  were captured
  177.        before screen capture was disabled.
  178.  
  179.  
  180.  
  181.  
  182.  
  183.                                                                        2
  184.  
  185.  
  186.        Compressing the scrollback buffer
  187.  
  188.        Each line that SCROLLit saves contains 80 characters and 80 color
  189.        attributes, requiring a  total of  160 bytes storage.  A full  25
  190.        line  screen  requires 4000  bytes  of  storage space.  There  is
  191.        usually a  lot of blank space on a screen, however, and the color
  192.        attributes are often  unchanged for  an entire line  of text  and
  193.        sometimes the whole screen. SCROLLit uses a very fast run-length-
  194.        encoded  compression  algorithm to  shrink  the  amount of  space
  195.        required to save a line of text and is typically able to compress
  196.        the scrollback  buffer by 60 to 70%, meaning that more than twice
  197.        the  number of  lines of  can be  saved in  the  available buffer
  198.        space.
  199.  
  200.        The  extent to  which  SCROLLit has  been  able to  compress  the
  201.        scrollback buffer is displayed when the help key (F1) is pressed.
  202.  
  203.                       ╒═════════════════════════════════╕               
  204.        For example:   │  Number of lines saved:  2046   │               
  205.                       │  Average bytes per line: 43     │               
  206.                       │  Percent compression:    73%    │               
  207.                       ╘═════════════════════════════════╛         
  208.  
  209.        There is some overhead in setting up the buffer, which means that
  210.        SCROLLit  will obtain  better  compression with  a larger  buffer
  211.        size.
  212.  
  213.  
  214.  
  215.        Installing and Unloading SCROLLit
  216.  
  217.        SCROLLit  is a memory resident (TSR) program that is installed in
  218.        memory  by typing  SCROLLit  followed by  the desired  scrollback
  219.        buffer  size in kilobytes. The buffer size  must be at least 20k.
  220.        For example, to install  SCROLLit with a 100k scrollback  buffer,
  221.        type:
  222.  
  223.                  SCROLLit 100
  224.  
  225.        You may wish  to store this command in your  autoexec.bat file to
  226.        ensure  that  SCROLLit  is  loaded  whenever  you  turn  on  your
  227.        computer. You  will need to  prefix the command with  the name of
  228.        the  directory where SCROLLit is  stored, or store  SCROLLit in a
  229.        directory that you have set in your path command.
  230.  
  231.        SCROLLit can be  unloaded from  memory with the  /U command  line
  232.